能力 – 域 – 事件 – 版本 –
🧪 API 示例中心 🛠 编辑器 📖 操作手册
🔍
共 – 项能力

DPE 数字样机编辑器 · 开放接口参考

共 – 项能力（– 个域）· – 类事件 · 版本 –。 本页由 manifest.json 自动渲染——能力清单随版本自动同步；命令行版（Markdown）可由 docs/gen-api-doc.js 再生成。 交互式运行请前往 API 示例中心。

① postMessage APIiframe

iframe 嵌入、跨域集成、零依赖。编辑器地址加 ?api=2 即握手。

iframe.contentWindow.postMessage({
  ns: "cimpro3d", ver: 2, id: "c1",
  cmd: "object.set",
  args: { target: "主轴", path: "visibility", value: false }
}, "*");

② JS SDK推荐

direct 直嵌（零序列化，高频快 15~27 倍）/ iframe 双模式自动协商，UMD / ESM / TypeScript。

<script src="sdk/cimpro3d-sdk.js"></script>
const client = await CIMPro3D.create('#viewer');
await client.call("object.set", {
  target: "主轴", path: "visibility", value: false
});

③ MCP大模型智能体

智能体经 MCP 网关（HTTP 8970 / WS 8971）透传调用全部能力，inputSchema 原样透传。

client.callTool({
  name: "object.set",
  arguments: { target: "主轴",
    path: "visibility", value: false }
});
三种形态的能力名与参数完全一致（单一事实源：内核能力注册表）。权限级别：read 只读 · write 写入 · danger 危险（MCP 默认拒绝，需 --allow-danger）。
events静态观察事件清单（订阅方式：SDK client.on / postMessage events.subscribe / MCP GET /events）